home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / util / libs / graphics3d.readme < prev    next >
Encoding:
Text File  |  1998-03-08  |  9.4 KB  |  207 lines
  1. Short:    3D graphics shared library V10.10(beta)
  2. Author:   p.biancalani@mbox.match.it
  3. Uploader: p.biancalani@mbox.match.it
  4. Type:     util/libs
  5.  
  6. Version        10.10
  7.  
  8. --- English ----
  9. First sorry for my bad English but I don't know it very well.
  10. This is a simple but complete graphic 3D library that use for visualization
  11. only the system library .
  12. Main feature include :
  13.  
  14.    - Visualization of object in systems windows with single buffering.
  15.    - Use of only fix point value than the math coprocessor is not
  16.      necessary, and is relatively fast on machines us A1200 base too.
  17.    - Implementation of visualization in Wire Frame ,Solid shading and
  18.      Flat shading all simultaneous too and with light source freely 
  19.      placeable .
  20.  
  21. Is tested on (for now): 
  22.    A4000/40 with S.O. 3.0
  23.    A1200 base with S.O 3.0
  24.  
  25. But now it is support a 68000 also (on a 68040 run) and I think that 
  26. S.O. 2.0 can be sufficent to run, (but I don't tested).
  27.  
  28. The rendering engine is entirely based on blitzbasic graphic3D engine V0.9
  29. by Maciej R.Gorny .
  30.  
  31. The library appears to be solid at my test but is only a beta version and
  32. if anyone want to be a betatester can send to me an E-Mail is welcome.   
  33.  
  34. This library is freeware than freely usable and distribuite but with all file
  35. of this original archive and not for resale or it can't be sold.
  36. If you want modify the original sources tell me than if it is ok I can 
  37. update all original archive.
  38.  
  39. I have included an example write in E (and full commented) and all the source in C of this library .The executable is 3dlib and it must be in the same
  40. directory of #?.plg files. 
  41.  
  42. The documentation is now all traslate in English too, but this is very dirty
  43. than sorry and if you found thinks that are not clear send me a e-mail and 
  44. I try to correct it. 
  45.  
  46. The file graphics3d_000.library is the library for CPU from 68000.
  47. The file graphics3d_020.library is the library for CPU from 68020.
  48. You must rename the correct library to graphics3d.library before use it.
  49.  
  50. Thanks to:
  51.    Maciej R.Gorny for the original routin of engine 3D.
  52.    Alessandro Franchi for beta testing on A1200.
  53.    VolKer Barthelmann author of VBCC the C compiler used by me to write the
  54.    library.
  55.    Andreas Kleinert author of the optimal startupcode for write shared
  56.    library. 
  57.    The authors of Tornado3D for the suggetions to implemented the single
  58.    buffering in a window. 
  59.    All ones that have write an e-mail to me.
  60.  
  61. I'am Patrizio Biancalani from Prato (Italy) and the my E-Mail for
  62. suggestions and signaling is :p.biancalani@mbox.match.it
  63.  
  64. --- Italiano ---
  65.  
  66. Questa e' una semplice ma completa libreria grafica 3D che si appoggia
  67. interamente sulle librerie di sistema per la visualizzazione.
  68. Le caratteristiche principali sono:
  69.    
  70.    - Visualizzazione oggetti nelle finestre con single buffering.
  71.    - Usa valori solo in fix point quindi il coprocessore non serve
  72.      ed e' relativamente veloce anche su macchine come il A1200 base.
  73.    - Implementa la visualizzazione in Wire Frame ,Solid shading e
  74.      Flat shading anche tutti contemporaneamente e con la fonte di 
  75.      luce posizionabile a piacere.
  76.  
  77. E' stata testata su(per ora):
  78.    A4000/40 con S.O. 3.0
  79.    A1200 base con S.O 3.0
  80.  
  81. Ma adesso e' supportato anche il 68000 (gira su un 68040) e penso che sia
  82. sufficente un S.0 dal 2.0 in poi. 
  83.  
  84. Il motore di rendering e' interamente basato sul blitzbasic 3d graphics
  85. engine V0.9 di Maciej R.Gorny .
  86.  
  87. La libreria si e' dimostrata alle mie prove abbastanza solida, pero' e'
  88. sempre una beta e se c'e' qualcuno disposto a farmi da betatester mi mandi
  89. subito un E-Mail sara' il benvenuto. 
  90.  
  91. La libreria e' freeware quindi liberamente usabile e distribuibile purche'
  92. con tutti i file del presente archivio e non per fini di lucro inoltre
  93. se volete modificare i sorgenti comunicatemelo cosi' se la cosa e' ok
  94. aggiorno tutto l'archivio.
  95.  
  96. Ho incluso anche un esempio di uso scritto in E e i sorgenti in C della
  97. libreria.L'eseguibile si chiama 3dlib e deve essere nella stessa directory
  98. dei file #?.plg .
  99.  
  100. La documentazione ora e' stata interamente tradotta anche in Inglese anche
  101. se in modo orribile, se qualcuno volesse farmi notare errori o meglio 
  102. correggerli e' veramente benvenuto.
  103.  
  104. Il file graphics3d_000.library e' per le CPU dal 68000.
  105. Il file graphics3d_020.library e' per le CPU dal 68020.
  106. Occorre rinominare la corretta libreria in graphics3d.library prima di
  107. usarla.
  108.  
  109. Si ringrazia :
  110.    Maciej R.Gorny per le routin del motore 3D.
  111.    Alessandro Franchi per il parziale beta testing su A1200.
  112.    VolKer Barthelmann autore del compilatore C VBCC da me usato per
  113.    la stesura della libreria.
  114.    Andreas Kleinert autore dell'ottimo startupcode per le shared
  115.    library. 
  116.    Gli autori di Tornado3D per il suggerimento su come implementare 
  117.    il single buffering in una finestra.
  118.    Tutti quelli che mi hanno scritto.
  119.  
  120. Io sono Patrizio Biancalani residente a Prato Italy e il mio E-Mail per
  121. suggerimenti e segnalazioni e': p.biancalani@mbox.match.it
  122.  
  123.  
  124. ============================= Archive contents =============================
  125.  
  126. Original  Packed Ratio    Date     Time    Name
  127. -------- ------- ----- --------- --------  -------------
  128.    10408    4833 53.5% 27-Feb-98 23:18:48  3dlib
  129.      351     181 48.4% 28-Jan-98 20:20:26  barrier.plg
  130.      590     235 60.1% 28-Jan-98 20:20:26  cube.plg
  131.     1370     555 59.4% 28-Jan-98 20:20:42 +graphics3D.fd
  132.     1021     580 43.1% 28-Jan-98 20:20:40 +graphics3D.i
  133.     1370     555 59.4% 28-Jan-98 20:20:42 +graphics3D.fd
  134.     8413    2714 67.7% 28-Jan-98 20:20:40 +graphics3D.h
  135.     1800     721 59.9% 28-Jan-98 20:27:42 +graphics3D_stub.lib
  136.      736     354 51.9% 28-Jan-98 20:20:42 +graphics3Dbase.h
  137.      547     273 50.0% 27-Feb-98 22:52:16 +graphics3D.m
  138.      254     153 39.7% 27-Feb-98 22:52:16 +graphics3D_lib.m
  139.     1636     856 47.6% 26-Feb-98 23:33:24  doc.info
  140.    11828    3386 71.3% 26-Feb-98 23:28:26 +graphics3D.h
  141.      352     224 36.3% 27-Feb-98 23:31:02 +graphics3d.history
  142.     1394    1083 22.3% 26-Feb-98 23:35:00 +graphics3d.history.info
  143.     3820    1541 59.6% 21-Feb-98 15:30:08 +graphics3d.notes
  144.     1394    1084 22.2% 27-Feb-98 23:39:42 +graphics3d.notes.info
  145.    35285    8228 76.6% 26-Feb-98 19:49:32 +graphics3d_E.doc
  146.     1154     757 34.4% 27-Feb-98 23:35:52 +graphics3d_E.doc.info
  147.    47344    9042 80.9% 26-Feb-98 23:28:32 +graphics3d_E.guide
  148.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_E.guide.info
  149.    36980    8798 76.2% 23-Feb-98 20:06:56 +graphics3d_I.doc
  150.     1154     757 34.4% 27-Feb-98 23:35:44 +graphics3d_I.doc.info
  151.    48869    9650 80.2% 26-Feb-98 23:25:10 +graphics3d_I.guide
  152.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_I.guide.info
  153.     4968    2218 55.3% 26-Feb-98 21:14:46  graphics3d.readme
  154.    32092   14057 56.1% 27-Feb-98 23:08:00  graphics3D_000.library
  155.    23304   12451 46.5% 27-Feb-98 22:52:14  graphics3D_020.library
  156.      130      71 45.3% 28-Jan-98 20:20:26  ground.plg
  157.      186     101 45.6% 28-Jan-98 20:20:26  lettera.plg
  158.      773     402 47.9% 28-Jan-98 20:20:24  letterT.plg
  159.      140      93 33.5% 28-Jan-98 20:20:26  missile.plg
  160.      146     106 27.3% 28-Jan-98 20:20:26  plane.plg
  161.      365     175 52.0% 28-Jan-98 20:20:26  pylons.plg
  162.      944     418 55.7% 28-Jan-98 20:20:24  pyramid.plg
  163.      267     155 41.9% 28-Jan-98 20:20:26  rock.plg
  164.     1146     394 65.6% 28-Jan-98 20:20:24  sfer.plg
  165.    30984    8128 73.7% 28-Jan-98 20:20:24  sfera.plg
  166.      481     221 54.0% 28-Jan-98 20:20:26  slider.plg
  167.     2330     661 71.6% 28-Jan-98 20:20:24 +3dlib-020.asm
  168.      526     401 23.7% 28-Jan-98 20:27:48 +3dlib-020.m
  169.    10248    3498 65.8% 27-Jan-98 22:46:18 +3dlib.h
  170.      235     166 29.3% 28-Jan-98 20:20:22 +3dlib.make
  171.     4388    1740 60.3% 28-Jan-98 20:20:22 +3dlibdemo.e
  172.     1125     603 46.4% 28-Jan-98 20:20:20 +3dlibh.h
  173.      129     102 20.9% 28-Jan-98 21:23:36 +compila
  174.    16336    4355 73.3% 28-Jan-98 21:27:22 +gad.h
  175.     2389     863 63.8% 13-Apr-97 09:58:52 +gen.h
  176.      547     273 50.0% 27-Feb-98 22:52:16 +graphics3D.m
  177.      254     153 39.7% 27-Feb-98 22:52:16 +graphics3D_lib.m
  178.      593     317 46.5% 28-Jan-98 20:20:44 +debuglib.c
  179.      269     152 43.4% 28-Jan-98 20:20:44 +debuglib.h
  180.     1370     555 59.4% 27-Jan-98 22:46:16 +graphics3D.fd
  181.     8413    2714 67.7% 21-Feb-98 15:30:02 +graphics3D.h
  182.     1021     580 43.1% 27-Jan-98 22:46:14 +graphics3D.i
  183.     4118    1271 69.1% 27-Feb-98 22:59:48 +graphics3D.make
  184.    14409    4318 70.0% 28-Jan-98 20:20:42 +graphics3D2d.c
  185.     1015     333 67.1% 28-Jan-98 20:20:42 +graphics3D2d.h
  186.      969     340 64.9% 28-Jan-98 20:20:42 +graphics3D2d_proto.h
  187.      736     354 51.9% 28-Jan-98 20:20:42 +graphics3Dbase.h
  188.      791     367 53.6% 28-Jan-98 20:20:42 +graphics3Dc.h
  189.    37940    9702 74.4% 28-Jan-98 20:20:40 +graphics3Df.c
  190.     3652     778 78.6% 28-Jan-98 20:20:40 +graphics3Df.h
  191.    26926    7766 71.1% 21-Feb-98 15:30:02 +graphics3Df_i.c
  192.     9129    2220 75.6% 28-Jan-98 20:20:42 +graphics3Df_i2.c
  193.     3375     769 77.2% 28-Jan-98 20:20:42 +graphics3Df_proto.h
  194.    11847    2696 77.2% 31-Jan-98 12:11:40 +graphics3Df_t.c
  195.     5447    1920 64.7% 21-Feb-98 15:30:02 +graphics3Dli.c
  196.      607     352 42.0% 21-Feb-98 15:30:04 +graphics3Dm68k.c
  197.     8295    2144 74.1% 28-Jan-98 20:20:40 +graphics3Dsu.c
  198.      431     187 56.6% 28-Jan-98 20:20:26  station.plg
  199.     9891    2576 73.9% 28-Jan-98 20:20:24  tall_piramyd.plg
  200.      375     151 59.7% 28-Jan-98 20:20:24  tall_pyramid.plg
  201.      538     233 56.6% 28-Jan-98 20:20:26  tallon.plg
  202.      508     249 50.9% 28-Jan-98 20:20:26  tele.plg
  203.    13003    3401 73.8% 21-Feb-98 13:17:24  test.plg
  204.      324     140 56.7% 28-Jan-98 20:20:26  tower.plg
  205. -------- ------- ----- --------- --------
  206.   521717  156460 70.0% 01-Mar-98 19:01:30   77 files
  207.